home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / wildfire.zip / WILDFIRE.DOC < prev    next >
Text File  |  1988-10-29  |  49KB  |  974 lines
  1.  
  2.                               WildFire Ver 1.5
  3.          A Live Program External Menu System and Execution Monitor
  4.                                     for
  5.                             Spitfire Ver 2.5+
  6.               
  7.                          (c) 1988 Stephen L. Cox
  8.                          A LiveStuff Presentation
  9.  
  10.  * Spitfire is trademark and copyright Buffalo Creek Software
  11.  
  12.    Welcome to the wonderful world of WildFire!!  WildFire 1.5 provides COMPLETE
  13. external menu and execution control of doors running under Spitfire 2.5 and
  14. up.  It adds many useful features to Spitfires slim support of doors. Here are
  15. the highlights of version 1.5..
  16.  
  17. *EXTERNAL MENUS - Registered versions provide 22 menus of 22 entries each.
  18.                   Shareware versions provide 2 menus of 4 entries each.
  19.           Allows up to 484 total doors in system
  20.  
  21. *NO BATCH FILES - Execute Wildcat!, RBBS and PCBoard and GAP doors without
  22.                   batch files.
  23.                    
  24. *RE-ENTRANT MENUS - All doors return to MENU instead of Spitfire FAST!!
  25.  
  26. *USER SELECTABLE MENUS - Users select new menus without return to Spitfire
  27.  
  28. *AUTO LOCAL SUPPORT - Runs MOST doors in LOCAL mode automatically
  29.  
  30. *RE-RUN LOCKING - Lock out multiple daily runs of each individual door!
  31.  
  32. *TIME CONTROL - Control the time users can spend in individual doors
  33.  
  34. *SECURITY CONTROL - Control security level for each individual door.
  35.  
  36. *MULTI-LEVEL TIME LIMITS - Different time limits for different security!
  37.  
  38. *EXPIRED DOORS - Automatically runs many expired doors!
  39.  
  40. *UP/DOWNLOAD RATIO DETECTION - Lock doors on ratios - multi-level-optional
  41.  
  42. *VAULT TIME LOCK - Lock doors completely during certain hours of the day!
  43.  
  44. *FULL FEATURED EDITOR - Includes editor to construct and edit menus.
  45.  
  46. *USES CSHELL 1.0 - Written in Microsoft C 5.0 using CSHELL door system!
  47.  
  48. *OTHER FEATURES TO NUMEROUS TO MENTION!!
  49.  
  50.  
  51. THE PRELIMINARIES:
  52.  
  53. [[[ Limited License ]]]
  54.      This software is copyrighted but a limited license is granted and you
  55.      are free to use and share it under the following conditions:
  56.       1.  WildFire is not distributed in modified form
  57.       2.  No fee or other consideration is charged for WildFire itself
  58.       3.  The REGISTERED USER version of WildFire MUST NOT be distributed
  59.       4.  Reference to the copyright and author is retained.
  60.       5.  If your callers like this program, or if you want updates sent to
  61.           you, or if you need support or immediate answers to problems
  62.      
  63.      Then please send a registration fee of $30.00 to:
  64.                             Steve Cox
  65.                             Flite-Line BBS
  66.                             938 N. 70th, Suite 102
  67.                             Lincoln, Ne.
  68.                                        68505
  69.  
  70.     With registration you receive:
  71.            Full registered copy of the latest version of WildFire
  72.            Program support
  73.                Updates via Flite-Line Download
  74.  
  75.  
  76.  
  77. [[[ Warranty ]]]
  78.  
  79.      The WildFire system is provided "AS IS" without warranty of any kind,
  80. either expressed or implied, including, but not limited to the implied
  81. warranties of merchantability and fitness for any purpose.  The entire
  82. risk as to the quality and performance of this program is with the user
  83. and should the program prove defective, the user and not the author will
  84. assume all responsiblity with correcting all information.  The author
  85. does not warrant  that this program will function in the desired mode or
  86. will meet any users requirements or that the operation of the program will
  87. be error free.
  88.  
  89. * THE INSTALLATION OF WILDFIRE ON YOUR SYSTEM CONSTITUTES ACCEPTANCE OF THE
  90.   ABOVE TERMS *
  91.   
  92.  This program is written in Microsoft 'C' V 5.0.
  93. ------------------------------------------------------------------------------
  94.  THANKS TO THE FOLLOWING:
  95.  
  96.    I am deeply indebted to the following people for their participation in
  97.    the beta testing phase of WildFire. Without their efforts this product
  98.    would not have been possible... Thanks guys!
  99.    
  100.    Don Gump, Silicon Alternative,   Fort Wayne IN.
  101.    Herb Mellinger, The Silicon Lab, Hudson     FL.
  102.    Alan Criado, PBM Connection  ,   Miami      FL.
  103.    Rick Kingslan, Lost Boys BBS ,   Omaha      NE.
  104.  -----------------------------------------------------------------------------
  105.    
  106.                           [[WildFire Overview]]
  107.  
  108.   The real reason WildFire was developed was to control time usage on my
  109. extremely active BBS system and to better organize the entire doors system.
  110. I currently run about 70 doors and have found it to be a problem because of
  111. the addictive nature of the games, especially those of the calibur of Trade
  112. Wars 500.  I wanted to encourage users to spend at least part of their daily
  113. time participating in other sections of the BBS besides the games.  I had 
  114. dozens of users logging in and playing out their entire daily time allotment in
  115. the doors and never doing anything else.  My reasoning was that if a user is
  116. limited to a certain amount of time that is something less than their daily
  117. board time, they might, just might, spend their remaining time doing other
  118. things.  Experience with LiveMon has shown this assumption to be correct.  The
  119. success with LiveMon led to the plan to expand it into the full blown door
  120. monitor that you are now looking at, WildFire!
  121.  
  122.   WildFire operates as a door program itself although a very special one. It's
  123. purpose is to tightly control the execution of other doors within your system.
  124.  
  125.   It organizes your doors into categories that let you place like games in
  126. specific menus. It also allows you to place a specific door in more than one
  127. menu.  The menu layouts follow those of Spitfire closely so they should present
  128. your users no problems.  You may have upto 22 menus of 22 entries each or
  129. 484 doors total in your system. Try doing THAT in your Spitfire DOORS menu.
  130. The Shareware version allows 2 menus of 4 entries each.
  131.  
  132.   Doors executed within the WildFire environment are no longer forced to return
  133. back to the BBS upon termination thereby forcing the user to go through the
  134. log-on sequence repeatedly.  Return from each door is back to the WildFire 
  135. menu from where the user started.  This saves a great deal of time for the 
  136. user and provides greater execution control for the sysop.  Users may change
  137. menus and move around at will, selecting any door your system has availabe
  138. without returning to the main board.
  139.  
  140.   WildFire provides built in support for door programs written to be run under
  141. serveral types of BBS systems.  Most of the doors we have available today
  142. were designed to run under either the PCBoard system or RBBS-PC.  At present,
  143. although growing, there are very few Spitfire specific doors available.
  144. Running doors for these other systems under Spitfire can be tedious at best
  145. and capable of producing cardiac arrest at worst!  WildFire does it's best
  146. to make this task easier.  It will automatically produce all the conversion
  147. files necessary to run doors for these other systems.  Doors for most all
  148. versions of Wildcat, PCBoard 11.x thru 12.x, doors for the newer versions
  149. of RBBS 15.1C and up, GAP doors, QBBS doors are supported. Most of them
  150. even in the LOCAL mode!
  151.  
  152.   The time monitoring features of WildFire allow you to set the maximum amount
  153. of time a user may spend in doors each day.  Additionally each
  154. individual door may have a time limit for each access by the user. These time
  155. limits are independent of the daily Spitfire time limit controlled by the users
  156. security level.  The timing features are multi-level in that users with
  157. different levels of security can be given different time allocations within
  158. WildFire.
  159.   
  160.   WildFire provides full security control of all the doors in your system.
  161. You can attach a security level to each door that will prevent users with
  162. lower security levels from executing it. This can be set for EACH
  163. door in your system.  You might for instance have a few doors that could be
  164. considered adult doors and you do not want them accessed by users without the
  165. proper clearance and verification. Or, you might have some doors that you
  166. want available only to registered or contributing users. You can assign those
  167. doors a security level that would let only the selected levels access them.
  168.  
  169.  
  170.   WildFire also provides a feature called 'Vault Time Lock' or VTL.  This
  171. feature allows you to completely lock your door system to ALL users between
  172. certain hours of the day.  Ever suffered the frustration of trying to get onto
  173. your own board during the day to do maintenance from some remote location, and
  174. couldn't get on because Joe was playing out 50 Trade Wars turns?  WildFire
  175. can alleviate this problem by making it impossible for users to enter the doors
  176. between the times you set.  This will at least keep gaming activity from
  177. interfering during your selected times.  The lock time can be as short as 1
  178. minute or as long as 23 hours and 59 minutes. You should be able to find a time
  179. slice that will meet your needs.
  180.  
  181.  
  182.   WildFire also provides a feature called 'UDR' or Upload/Download Ratio 
  183. monitoring.  This feature will allow you to optionally lock the doors system
  184. to users who have exceeded the pre-set up/dn load ratios. 
  185.  
  186.   WildFire provides a method whereby SOME expired doors can be run indefinetly
  187. on your system.  There are several criteria that must be judged before using
  188. this feature.  It is NOT provided as a way to keep you from having to 
  189. register a door that is useful to you!! It is inteneded to help you and your
  190. users evaluate some of those doors that you download and find already 
  191. expired after you get them.  If you continue to use the door then you SHOULD
  192. register it to encourage the author to produce other works that are of use
  193. to you. 'EDS' or expired door support will not work on all the variations you
  194. find. The only way to find out is to try it and see if it will work.
  195.   
  196.   One other feature worth mentioning that WildFire provides to you is Re-Run
  197. locking.  You may mark any door in your system as a 'run once only' door and
  198. the user will automatically be prevented from accessing it more than once
  199. a day.  Nice for the addicts out there that never get a chance to see what
  200. else you have because they can't tear themselves away from Star Traders or
  201. whatever.
  202.  
  203.   That pretty well sums up what WildFire is and what it can do for you.  While
  204. the features that it provides are extensive, it is relatively easy to set
  205. up and run.  I have  provided a full featured editor for the menu system to
  206. make the task of door installation into WildFire nearly painless.  I hope
  207. you enjoy it.  If it proves usefull to you and your users then please
  208. register it and encourage me to continue to enhance it.  I believe that 
  209. WildFire will prove to be a valuable enhancement to an already superb piece
  210. of software, Spitfire
  211. ------------------------------------------------------------------------------
  212.  
  213. [[INSTALLATION OF WILDFIRE]]
  214.   
  215.  The package you downloaded should contain the following files. If any of the
  216.  files listed below were not included, call Flite-Line BBS to download the
  217.  latest Shareware version:
  218.  
  219. WILDFIRE.EXE      The main menu/monitor system  Version 1.5sw
  220.  MENEDIT.EXE      V 1.5 of the menu editor
  221.    LCTCP.EXE      The PCBoard time calculator
  222.    LCTCR.EXE      The RBBS time calculator.
  223.    LCTCG.EXE      The GAP time calculator.
  224. WILDFIRE.CFG      Example menu/monitor runtime configuration file
  225. WILDFIRE.PRM      Example contains the time control parameters for WildFire.
  226.  MENEDIT.PRM      Configuration and important info for the editor.
  227.   LCUSER.DAT      Initialized empty user file
  228. WILDFIRE.DOC      This documentation.
  229. PROBDOOR.DOC      Listing of doors with known problems 
  230.   README.1ST      Last minutes notes not in the documentation
  231.  GAMEDES.BBS      Beginning games description file.
  232.  MENEDIT.RPM      Duplicate of MENEDIT.PRM for restart
  233.       SF.TAB      Sample SF.BAT to run WildFire with Spitfire
  234.     TIPS.DOC      Tips from the author on running doors.
  235.  DAT4PCB.ARC      Sample PCBOARD.DAT file and docs to get you started
  236. STARTOVR.BAT      Batch file to kill all necessary files after done practicing
  237.                   your setup so you can start over.
  238.            
  239.  Files created at runtime by the editor:
  240.  
  241.  MNAMES.LST       Menu names
  242.  MDESCP.LST       Menu description lines
  243.  LCMENU.SCN       File containing all the WildFire menus
  244.  XXXXXXXX.SCP     One file for each menu, contains the execution script for
  245.                   each door listed in the menu.
  246.  
  247.  
  248.  Setup of WildFire is relatively easy but you MUST DO IT RIGHT!!!!
  249.  
  250.  Step 1:  Make a backup copy your current SF.BAT file. It will require
  251.           some changes to run WildFire and we want to keep the original
  252.       safe till everything is ready to go.
  253.       
  254.  Step 2:  Copy all of the WildFire files to a separate subdirectory. I
  255.           recommend that this should be 1 directory down from the Spitfire
  256.       directory. IE: \sf\wildfire.. You may place all .EXE files
  257.       in the WildFire system in a ram disk or anywhere in your DOS
  258.       search path but all DATA files MUST be in the WildFire directory.
  259.       
  260.  Step 4:  Modify the WILDFIRE.CFG file. This file contains all of the
  261.           ENVIRONMENT information for WildFire.  Modify it per the example
  262.       below to conform to your needs.
  263.       
  264.       
  265. Line #1   1                        <-- Comport (Do not include COM:) 
  266. Line #2   Flite-Line               <-  BBS Name (35 Characters max);
  267. Line #3   Steve                    <-  Sysop first name (15 charachters max)
  268. Line #4   Cox                      <-  Sysop Last name (25 characters max)
  269. Line #5   NONE                     <-  19200 if locked DTE otherwise NONE
  270. Line #6   c:\sf\sfds.org           <-  Path to the door info file
  271. Line #7   c:\sf\callers.log        <-  Path to the activity log
  272.        
  273.         The above configuration file MUST be set correctly or WildFire will
  274.     not run!!
  275.     
  276.  Step 5: Modify the WILDFIRE.PRM file.  This file contains all of the TIMING
  277.          parameters that WildFire will use. Modify it per the example and
  278.      explanations below.
  279.      
  280.        The format of the WILDFIRE.PRM file is as follows:
  281.  
  282. Line #1   67        <- door time limit in percent or flat minutes
  283. LIne #2   10        <- Upload/Dnload ratio lockout at 10:1 
  284. Line #3   1         <- percent or flat time flag
  285. Line #4   07:00     <- Start time to lock doors (VTL)
  286. Line #5   08:00     <- End time for door locks (VTL)
  287.                 
  288.  Explaination of each line follows:
  289.   Line #1:  May be 10 to 99.
  290.             This number is interpreted one of two different ways. In one case
  291.             it is the maximum number of minutes ANY user regardless of
  292.         security level can spend total in door programs in one day. In
  293.         the second case it as a PERCENTAGE of TOTAL BOARD TIME that the
  294.         user may spend in door programs in one day.  It's interpretation
  295.         is controlled by line #3.
  296.         
  297.   Line #2:  May be 0 (zero) to x (any number)
  298.             This number controls the upload download ratio lockout feature.
  299.             In the example above, if the user entered WildFire and their 
  300.         up/dn load ratio was not within 10 to 1 they would be locked out
  301.         of the doors until they had done some uploading. This number can
  302.         be any ratio you wish.  If you do NOT wish to use this feature
  303.         then just set line #2 to a 0 (zero) and ratio monitoring will be
  304.         disabled.
  305.                 
  306.   Line #3:  May be 0 (zero) or 1 (one).
  307.             This line is important. It tells WildFire how to interpret Line #1.
  308.             If you set line 3 to a 0 (zero), WildFire will interpret line #1 as
  309.         a flat time and whatever number is in line #1 will be assigned
  310.         to every user as their maximum allowable door time.  If line #3
  311.         is set to a 1, WildFire treats the number in line #1 as a
  312.         percentage. It will calculate the daily doors time for a
  313.         user by examining the dailylmt.bbs file to see how much daily
  314.         board time a user with this security level is allowed and then
  315.         assign the indicated percentage of that time as total daily
  316.         door time. This effectively allows users with higher security
  317.         levels that give them more daily BBS time to also have
  318.         correspondingly higher daily door program times.
  319.  
  320.   Line #4  May be 00:00 to 23:59
  321.            This line tells WildFire when to TOTALLY lock the door system (VTL)
  322.        
  323.   Line #5  May be 00:00 to 23:59
  324.            This line tells WildFire when to OPEN the door locks (VTL)
  325.        
  326.        Doors will be totally locked between the times in lines #4 & #5
  327.               
  328.   After initial setup of the WILDFIRE.PRM file it can be edited and changed
  329.   with ease by the menu editor program.  Thats all there is to configuring
  330.   WildFire itself. Please read the above descriptions competely until you
  331.   understand them. The setup of these two files is crucial to the proper
  332.   operation of WildFire.  It is extremely important that the two path lines
  333.   in the WILDFIRE.CFG file be set correctly. If not set to the proper directory
  334.   WildFire will absolutely refuse to function properly.
  335.   
  336.   Here is a graphic of how I have WildFire set up on my system:
  337.   DRIVE C:
  338.                             /TW500M
  339.                           /
  340.                   /DOORS 
  341.                 /
  342.   ROOT DIRECTORY
  343.                 \
  344.                   \SF   \
  345.                   \
  346.                             \WILDFIRE
  347.                            all WildFire files
  348.  
  349.  This corresponds exactly to the way the path lines (#6 and #7) are set up
  350.  in the WILDFIRE.CFG file.
  351.  
  352. **** SPECIAL NOTE **** **** IMPORTANT *****
  353.  In order for WildFire to do all the things it is designed to do, you MUST pay
  354.  close attention to your use of security levels in Spitfire.  It is
  355.  recommended that you only use the MINIMUM number of security levels to
  356.  properly secure your system.
  357.  
  358.   In a Spitfire system, the most important file to WildFire is a file called
  359.   'DAILYLMT.DAT'. This file contains an entry for each security level being
  360.   used in your Spitfire system and the total amount of daily BBS time users
  361.   with that security level can have.  This file is read by WildFire when a
  362.   user enters doors for the first time each day.  It looks up their security
  363.   level in this file and then determines how much daily time they can have.
  364.   This time is the one against which all other WildFire time calculations 
  365.   are performed.  YOU SHOULD MAKE SURE THAT THERE IS AN ENTRY IN THE
  366.   DAILYLMT.BBS FILE FOR EACH SECURITY LEVEL IN USE ON YOUR SYSTEM..
  367.   
  368.   If WildFire cannot find a security level in the DAILYLMT.BBS file that 
  369.   matches the one assigned to the user that just entered doors, it will
  370.   by default assign security level 10 and a maximum daily board time of
  371.   30 minutes.  It will use these numbers to calculate the door control times.
  372.   
  373.   I further recommend that you assign to yourself, as sysop, a security level
  374.   of 1000 and make sure it is entered in the DAILYLMT.DAT file with the
  375.   proper time limits.  This makes it easier for Wildfire to recognize you
  376.   as the sysop and not control you as tightly as a regular user.
  377.   
  378.  ---------------------------------------------------------------------------
  379.  NOTE:
  380.   In the following pages I have chosen to present the editor to you more in
  381.   the form of a step by step tutorial rather than just a disjointed list of
  382.   functions.  My suggestion is that you use the documentation to create a few
  383.   sample menus to get the feel of things.  Once you feel ready, delete all
  384.   the practice files with the included STARTOVR.BAT batch file and then go to
  385.   it for real.  Some may not like the format of this documentation, others
  386.   will.  I'm not entirely happy with it myself and I will be continuosly
  387.   revising it.  Any suggestions you could provide would be greatly appreciated.
  388.   
  389.   
  390.  [[ YOUR ORGANIZATION ]]
  391.  
  392.  Before you actually start building menus for WildFire, you need to spend some
  393.  time thinking about and planning how you will organize your doors.
  394.  
  395.  WildFire can keep everything orderly for you only if you do your planning!
  396.  
  397.  Running under WildFire it is best to categorize all of your doors into
  398.  specific themes such as WAR GAMES, Trivia Games, Board Games and so on.
  399.  You will want to create a Spitfire DOORS Menu that presents the user a
  400.  selection of all these categories, and then you will want to take care
  401.  to place all the doors of the same type into the appropriate WildFire menu.
  402.  
  403.  Here is a reproduction of the Spitfire DOORS Menu I use on my system.
  404. ----------------------------------------------------------------------------- 
  405.  
  406. >>>>>>>> SPITFIRE DOOR MENU <<<<<<<<
  407. <1> ... War Games                    <2> ... Adventure Games
  408. <3> ... Trivia Games                 <4> ... Quick & Easy Fun Games
  409. <5> ... Database Systems             <6> ... Simulations
  410. <7> ... Demos for Sysops             <8> ... Unavailable to you
  411.  
  412.  
  413.  -----------------------------------------------------------------------------
  414.  
  415.  The corresponding SFDOOR.MNU file would like this to support the above
  416.  structure:
  417.                War Games,10
  418.            Adventure Games,10
  419.            Trivia Games,10
  420.            Quck & Easy Fun Games,10
  421.            Database Systems,10
  422.            Simulations,10
  423.            Demos for Sysops,10
  424.            
  425.  Set the security level (10 in the above example) to the LOWEST level in use
  426.  on your system for ALL of the menu entries and then let WildFire handle
  427.  the individual door security for you.             
  428.  
  429.  
  430.   The above example illustrates the categorization of a WildFire system that 
  431.  could have up to 154 doors, or 22 entries in each of the 7 categories.
  432.  
  433.  The door numbers shown each correspond to a DOOR_X entry in the SF.BAT file
  434.  required to start WildFire with the indicated menu as the default.
  435.   
  436.  Now that you have decided how you will categorize your doors and how many
  437.  categories there will be, you must name each one of them.
  438.  
  439.  A CATEGORY name and a MENU name are the same thing.  A category or menu name
  440.  must follow all the rules of a DOS FILE NAME, 8 characters or less, no spaces
  441.  and alphanumeric characters .  These category names will be displayed to the
  442.  user when they are inside WildFire so they should be descriptive.  Door #1 on
  443.  our example Menu screen is WAR GAMES. Inside this category we will have
  444.  Trade Wars II, Power Struggle, Galactic Conquest and other war game doors.  It
  445.  seems that a logical name for this menu or category might be WARGAMES, right?
  446.  Right now, decide on the names that you will use for the menu categories you
  447.  decided on.
  448.  
  449.  Now that we have decided how many categories we will have and what their names
  450.  are, we must construct 1 entry in the SF.BAT file  for each of them. This
  451.  SF.BAT entry is VERY simple.
  452.  
  453.  Again, using door #1 in our example, named WARGAMES, here's what we would do.
  454.  
  455.  If you placed WildFire in it's own directory according to the structure I
  456.  recommended earlier, heres what your DOOR_1 entry in SF.BAT would look like.
  457.  
  458.  COPY SFDOORS.DAT SFDS.ORG
  459.  CD \SF\WILDFIRE
  460.  WILDFIRE WILDFIRE.CFG WARGAMES
  461.  CD \SF
  462.  
  463.  If you placed all of the WildFire files right in the Spitfire directory, here
  464.  is what the DOOR_1 ENTRY would look like.
  465.  
  466.  
  467.  COPY SFDOORS.DAT SFDS.ORG
  468.  WILDFIRE WILDFIRE.CFG WARGAMES
  469.  
  470.  See, very simple!  Construct one of these DOOR_X enties in the SF.BAT to
  471.  correspond to the number and name of each of the categories in your
  472.  proposed Spitfire DOORS Menu.
  473.  
  474.  If you placed WildFire in it's own directory then it is EXTREMELY IMPORTANT
  475.  that the commands to CD to the WildFire directory and then back to the
  476.  Spitfire directory be in the proper place or you will have a mess! 
  477.  If you previously had doors running on your system and you ever got your
  478.  directory changes wrong you will understand what I'm saying.
  479.  
  480.  
  481.  Once you have determined what your menu categories will be, named them and
  482.  constructed a DOOR_X entry for each of them, make a list of the doors that
  483.  you will include in each category and write down the category name, you will
  484.  need all this information to construct your WildFire menus with the editor.
  485.  ----------------------------------------------------------------------------
  486.   
  487.  [[ CREATING NEW MENUS ]]
  488.  
  489.  The next step in configuring WildFire to run on your system is to build
  490.  the system menus and install the execution script for each door in your
  491.  system.
  492.  
  493.  The WildFire editor is designed to make this as easy and intuitive as 
  494.  possible, but I'll warn you now, it's going to take some time and work.
  495.  
  496.  Make sure you are logged into the WildFire directory and that all of the
  497.  WildFire files from the ARC package are there.  If you are ready to start
  498.  building just type: MENEDIT
  499.  
  500.  The intro screen of the editor does a little salesmanship for me and then
  501.  expects you to press <ENTER> to get started.  When you press <ENTER> the
  502.  main operating menu appears.
  503.  
  504.  Building a menu with the editor is a three step process and isn't difficult
  505.  but you must have the particulars of each door you are going to install at
  506.  hand.  This includes the name of the directory in which the door resides, the
  507.  name of the executable program, the name of the .CFG if any, associated 
  508.  with the door, and the type of BBS that the door was designed for.
  509.  
  510.  All of the work in setting up WildFire comes at the front end when you are
  511.  installing all of your existing doors for the first time.  After that, the
  512.  installation and maintenance of doors inside WildFire is extremely fast and
  513.  simple.
  514.  
  515.  Step 1:  [F1] Create/Select menu
  516.           This is the first step in building a new menu or editing an existing
  517.       one.  In WildFire, each menu has a name by which it is referenced.
  518.       Press F1 now and the menu selection window will open.  Since this
  519.       is your first menu it will be blank and you are being prompted for
  520.       the name of a new menu.
  521.       
  522.       The menu name you enter here is the CATEGORY name you selected
  523.       in the previous step and put into each of the DOOR_X entries in
  524.       the SF.BAT file. Remember, menu names MUST follow all the rules of
  525.       a DOS file name. They must contain standard characters, no spaces
  526.       and they must be 8 or less characters in length. The name you chose
  527.       for the menu will be displayed to the user while in WildFire so
  528.       the names should be meaningful. We are going to build the menu for
  529.       our WARGAMES category and we are going to install two doors in
  530.       it: Trade Wars 500 and Power Struggle. Type in WARGAMES now and
  531.       press <ENTER>.
  532.       
  533.       When you pressed <ENTER> a verification window opens and asks you
  534.       if in fact this IS a new menu and this IS what you want to name it.
  535.       Simply answer Y or N and the editor will act appropriately.
  536.       
  537.       If you answered Y to the verify prompt another window opens (I love
  538.       windows) and you are prompted for a description of the menu being
  539.       created.
  540.       
  541.       These one line descriptions are displayed to the user while in 
  542.       WildFire so they also should be as descriptive as possible within
  543.       the one line allowed.  The description for our WARGAMES menu might
  544.       look like this: WAR GAMES (Space & Sea) Multi & Single Player.
  545.       
  546.       When you enter your menu description and press <ENTER> you are taken
  547.       automatically to a fresh menu entry screen.
  548.       
  549.       It's hard to do much wrong in this screen. Just enter the menu
  550.       entries as you wish the user to see them.  All of the editing keys
  551.       are available including INSERT, DELETE, BACKSPACE and all of the 
  552.       ARROW keys. Left and Right arrows move you back and forth in the
  553.       field and the Up and Down arrows move you between fields.
  554.       
  555.       The one thing you must NEVER DO in this screen is leave BLANK FIELDS
  556.       between entries. You MUST fill out the entries in sequential order
  557.       or you will blow WildFire's mind.
  558.       
  559.           We are putting in two entries. The highlight bar is setting at entry
  560.       [A] waiting for input. Let's type in: Trade Wars 500 (don't indent,
  561.       the first character must be at the left margin). Pressing <ENTER>
  562.       moves you to the [B] entry position. Type in: Power Struggle 3.0 and
  563.       again press <ENTER>.  The highlight has now moved to [C]. We only
  564.       want these two entries in our menu so this completes our entry.
  565.       To save these two entries press CTRL+ENTER. This saves the new
  566.       screen, sets up some system parameters and leads to step 2. You
  567.       can press CTRL+ENTER in almost any screen to save the current state
  568.       and return to the main menu.
  569.       
  570.   Step 2: DOOR ATTRIBUTES
  571.           The door attributes are the heart of the WildFire system. They are
  572.       responsible for exerting the control over the door and the user
  573.       
  574.       The name of the door whose attributes we are entering is displayed
  575.       in the window border so you don't get confused about which entry
  576.       you are working with.
  577.       
  578.       You should be seeing the attribute window for Trade Wars 500 right
  579.       now.
  580.       
  581.       Each door installed in WildFire has a door number. This number is
  582.       assigned by the system and cannot be changed once the door has
  583.       been installed.  The door number is used internally by WildFire to
  584.       control re-run locking.
  585.       
  586.       The first attribute you can enter is the BBS type flag.  WildFire
  587.       can handle doors for several types of BBS systems. Wildcat 1.10 and
  588.       1.11, Wildcat 1.12, PCBoard, GAP, QBBS and certain types of
  589.       RBBS-PC doors. For more information on the specifics of the door 
  590.       types that WildFire can handle, refer to appendix A.
  591.       
  592.       Since we are installing the Mutli-Board version of Trade Wars 500
  593.       it has a Wildcat 1.10/1.11 interface.  Enter the letter 'W' for
  594.       Wildcat and press <ENTER>. If it had been a PCBoard door you would
  595.       have entered 'P' and for RBBS you would have entered an 'R'.
  596.       See, that isn't so difficult is it?
  597.       
  598.       Now enter the number of minutes PER SESSION that a user will be
  599.       allowed to be in this door.  I limit my TW players to 30 minute
  600.       sessions.
  601.       
  602.       Now enter the security level that is required to run this door.
  603.       The security level you enter here is a 'greater than or equal to'
  604.       number. I require a minimum of level 20 for playing trade wars. If
  605.       you enter 20 here then all users with security level 20 and UP will
  606.       be allowed in the door.
  607.       
  608.       Next you are asked if you wish to permit the user unlimited runs of
  609.       the door daily or if it will be restricted to 1 run per day. You
  610.       be the judge!  If you answer 'Y' here, then the door is locked to
  611.       the user after return from the first run.  If you answer 'N' then
  612.       the user will be able to enter the door as many times as they want
  613.       within their time limits.
  614.       
  615.       The next prompt is for expired door support or 'EDS'. If you enter
  616.       a 'Y' to this prompt then WildFire will alter the system at run-time
  617.       and try to execute the door. This may work with the selected door
  618.       and it may not. It just depends on how the author chose to block
  619.       it.  The only way to find out is to try it!  Since Trade Wars is
  620.       not an expired door, enter 'N'
  621.       
  622.  Step 3:  EXECUTION SCRIPTS
  623.        Now the editor jumps to the EXECUTION SCRIPT screen.
  624.       
  625.       Entering an execution script is very easy to do if you have all of
  626.       the info about the door.  Each script can be upto 13 lines in length
  627.       and each line can be upto 70 characters wide. As in the menu entry
  628.       window, all of your editing keys are active.
  629.       
  630.       When you enter an execution script it MUST NOT CONTAIN anything
  631.       other than pure DOS commands. You MUST NOT enter batch language 
  632.       commands such as IF ERRORLEVEL and IF EXIST in the script, although
  633.       you CAN place the names of batch files themselves in the script.
  634.       Enter only the bare minimum commands to change to the directory
  635.       where the door is at, execute it and change back to the WildFire
  636.       directory.
  637.       
  638.       I have all my doors in a subdirectory off of root named DOORS.
  639.       Each door has it's own subdirectory below that. Trade Wars is in
  640.       a directory named TW500M. The entire path to TW on my system is:
  641.       C:\DOORS\TW500M.  Remember that and try to visualize the paths
  642.       as we create the script.
  643.       
  644.       The script on MY system would like this, you just change it to
  645.       suit your path names.
  646.       
  647.       cd \doors\tw500m
  648.       tw2
  649.       cd \sf\wildfire
  650.       
  651.       Thats it!!  Notice that I did NOT include a command to restart
  652.       Spitfire such as 'sf.bat' or a command to restart WildFire. Thats
  653.       because WildFire is memory resident throughout door execution. You
  654.       don't want to run Spitfire again at this point or you would have one
  655.       screaming nightmare on your hands.
  656.       
  657.       In ALL cases you MUST NOT run other types of file format coverters
  658.       such as WC2PCB or MAKEPCB to convert from one board type to another
  659.       unless you are specifically instructed to do so by this documentation
  660.       because WildFire does all that for you and if you try to include
  661.       these other conversion uitlities in your script you DEFEAT WildFire's
  662.       attempt to time control the door.
  663.  
  664.       There are some special characters available that you can put in
  665.       the script file to instruct WildFire to take some specific action
  666.       before the door is run.  These special action characters are the
  667.       predecessor to a full blown COMMAND LANGUAGE that will be upcoming
  668.       in Version 2.0 and will be documented at that time.
  669.       
  670.       I don't recommend that you use 'carrier watchers' in your system
  671.       such as Watchdog because the reboot forced by them does not allow
  672.       any user information to be updated. My opinion is that you are
  673.       better off to take those doors completely out of your system that
  674.       hang themselves up on a carrier drop. BUT, if you wanted to run
  675.       watchdog in the above script it would look like this:
  676.       
  677.       
  678.       watchdg1 ON
  679.       cd \doors\tw500m
  680.       tw2
  681.       cd \sf\wildfire
  682.       watchdg1 OFF
  683.       
  684.       NOTE: If you DO run watchdog with any of your doors you will NOT
  685.             be able to run them in LOCAL mode from WildFire.
  686.       
  687.       Again, very simple!  Any DOS command can be included in the script
  688.       such as commands to copy files back and forth and so on. Generally
  689.       speaking, you can put anything in this script that you would put
  690.       in a batch file, except batch language commands themselves.
  691.       
  692.           NOTE:
  693.       In the case that a user should drop carrier while inside one of
  694.       the doors, WildFire IS smart enough to catch them at it and still
  695.       get their time use records updated if Watchdog is NOT used.  As the
  696.       door program senses that carrier was dropped and shuts itself down,
  697.       WildFire intercepts the exit and recognizes that carrier was dropped
  698.       and goes ahead and updates the users time record and then recycles
  699.       Spitfire.  If you use watchdog this feature is defeated. Be aware
  700.       however that are conditions under which a door can lock up and
  701.       not release itself from memory.  This happens most often to doors
  702.       that are written in Basic.  They will hang up when the BRUN runtime
  703.       support package reports an error and will not release until a 
  704.       carriage return is entered from the local keyboard.  This is the
  705.       kind of thing that Watchdog can catch and WildFire cannot, although
  706.       many times even Watchdog is unable to act when this happens.
  707.       
  708.       NOTE:
  709.       It is EXTREMELY IMPORTANT that if directory changes are required
  710.       in your script to run the door, that you return back to the WildFire
  711.       directory when the execution is complete.  If you end up in the
  712.       Spitfire directory or some other,  you are going to have a mess! It
  713.       won't hurt anything in your system, but your time records will not
  714.       be updated and subsequent runs of a door will probably fail and the
  715.       user may not be able to return back to Spitfire  You MUST get that
  716.       script correct.
  717.       
  718.       After you have entered the last line of your script, press good ole
  719.       CTRL+ENTER and the script will be saved away. Trade Wars has now
  720.       been installed in WildFire.
  721.       
  722.       The editor has now looped back to the ATTRIBUTE window for the
  723.       next menu entry, Power Struggle. Just follow the same procedure
  724.       for installing PS as we did for Trade Wars.
  725.       
  726.   That completes all the steps necessary to install a door into WildFire. It
  727.   may seem a bit confusing the first time or two that you do it, but as soon
  728.   as you get used to the procedure you will find that the editor makes it very
  729.   easy and fast to install a new door, edit an existing one and to diagnose a
  730.   problem with any door in your system.
  731.  ----------------------------------------------------------------------------
  732.  
  733. [[ EDITING EXISTING DOORS ]]
  734.  
  735.   It is neccessary from time to time to edit menus that are already in your
  736.   system.  This is how you would add a new door to an existing menu or alter
  737.   some aspect of a door that is already in the system. You might want to 
  738.   change the time users have for the door, it's required security or possibly
  739.   change the re-run lock flags.
  740.   
  741.   To edit an existing menu you first need to SELECT a menu to work with. You
  742.   do this just as if you were entering a new menu, by pressing F1 at the
  743.   main menu.  Instead of typing the name of a NEW menu, just type the name
  744.   of one of the existing menus that are displayed to you in the window.
  745.   
  746.   When you type the name of the menu you want to edit, the editor sets up
  747.   everything, loads the requested menu and takes you to the edit screen.
  748.   
  749.   The edit screen has two windows.  The small window at the top tells you what
  750.   you can do, and the big window shows you what you can do it to!
  751.   
  752.   The two primary functions of the edit mode are to 1) F1 Edit menu entries
  753.   or 2) Edit and change attributes and scripts.
  754.   
  755.   EDITING MENU ENTRY TEXT
  756.   F1 Edit menu entries.
  757.   
  758.   This is the function that you would use to change the displayed menu entry
  759.   that the user sees.  When you press F1, the highlight bar is position on
  760.   entry [A].  You may change the entry in anyway you wish but you MUST NOT
  761.   LEAVE IT BLANK.  The only entry you may change to a blank entry is the
  762.   last one.  What I am trying to tactfully tell you here is that the
  763.   editor is NOT smart enough (yet) to reorder all the entries following
  764.   the blank entry. In other words, once any entry except the last entry has
  765.   something in it, it MAY NOT BE DELETED.  If you wish to delete a menu
  766.   item then I suggest that you move the last valid entry in your menu to the
  767.   one you want to delete, and then delete the last one by just replacing the
  768.   text with blanks!  I hope that makes sense.  A later release will include
  769.   the ability to delete and automatically re-order the entries.
  770.   
  771.   When in the entry edit mode, all of your keyboard editing keys, the backspace
  772.   all the arrow keys, insert and delete are active.  Just experiment a bit
  773.   and you will get the hang of it.
  774.   
  775.   After you have changed all of the desired entries in your menu, press the
  776.   CTRL+ENTER keys to save your changes. The highlight bar disappears and you
  777.   can now edit the attributes and scripts if you wish by pressing F2, or you
  778.   can return to the main menu by pressing F9.
  779.   
  780.   EDITING SCRIPTS AND ATTRIBUTES.
  781.   Edit menu function F2
  782.   
  783.   To edit the script and attributes for any door, just press F2.  When you
  784.   press this key, a small window opens and asks for the item you wish to
  785.   edit.  This window will not allow you to select the script for non-existant
  786.   entry.
  787.   
  788.   When you select a valid entry, the attribute window you saw when you were
  789.   entering your menus appears and the current attributes are display. You
  790.   can change any of them or you press press CTRL+ENTER to bypass the attributes
  791.   and go directly to the script window.
  792.   
  793.   The script window displays the current execution script for the selected
  794.   door, positions the highlight bar on the first line and goes into text
  795.   edit mode.  Use the arrow keys, DEL and INS keys and do anything to the
  796.   script you need to do.  When finished, hit CTRL+ENTER and the changes will
  797.   be saved. If you do not hit CTRL+ENTER, your changes will NOT be saved. This
  798.   is true anyplace you have the option of hitting CTRL+ENTER.  Hitting ESCAPE
  799.   for instance will exit the edit screen you are currently in and will NOT
  800.   save any changes you made.
  801.   
  802.   When the script window closes you again see the edit menu and selections
  803.   screen.  If you are done editing your entries just press F9 to return to
  804.   the main menu or repeat your editing steps for any of the displayed entries.
  805.   
  806.   ----------------------------------------------------------------------------
  807.   
  808.   PRINTING ATTRIBUTES AND SCRIPTS
  809.   Main Menu
  810.   F3 Print Attributes and Scripts
  811.   
  812.   The ability to print scripts and attributes can be a valuable diagnostic
  813.   aid in locating a problem with a specfic door or menu.  The script printer
  814.   gives you a paged listing by menu name of all the doors, their  attributes
  815.   and scripts in your system.
  816.   ---------------------------------------------------------------------------
  817.  
  818.   RENUMBERING DOORS:
  819.   Main Menu
  820.   F4 Renumber doors
  821.  
  822.   This function in the main menu is provided as a safeguard.  During the
  823.   development of WildFire we had a number of situations develop that resulted
  824.   in the door numbers getting out of sequence. This doesn't really cause a
  825.   problem unless two doors get the same number, or you get more than a couple
  826.   of hundred doors in your system.  I included this so that if a problem
  827.   ever did develop you would have a way to resolve it easily. I'd suggest
  828.   you run this function after about every 10 or 12 new doors you put into
  829.   the system.
  830.   
  831.   ---------------------------------------------------------------------------
  832.   
  833.   EDITING SPITFIRE TIME PARAMETERS
  834.   Main Menu
  835.   F5 Edit WildFire system parameters.
  836.   
  837.   This function is very easy to use and self explanitory. It allows you to
  838.   quickly change any of the WildFire timing parameters such as VTL lock and
  839.   un-lock times, maximum daily live program time ETC:
  840.   
  841.   ---------------------------------------------------------------------------
  842.   (yes, I'm getting tired of writing documentation!)
  843.   ---------------------------------------------------------------------------
  844.   
  845.  [[BOARD LOCAL MODE]]
  846.  If you have followed all of the steps above, WildFire should be ready to run.
  847.  The easiest way to see if everything is working is to boot up Spitfire and
  848.  go into Spitfire locally.  Log onto Spitfire using ALT-Q for local log on and
  849.  when Spitfire starts up hit [S] for Spitfire DOORS just as if you were a 
  850.  remote user.  Your new DOORS menu should appear.
  851.  
  852.  If your new Spitfire DOORS menu displayed normally just press the number for
  853.  any one of the categories in the screen and WildFire should come up running
  854.  showing all the entries for that particular category.
  855.  
  856.  Select any one of them by pressing the associated letter indicator.  If you
  857.  set up your script properly, and you configured the door itself properly,
  858.  the door should start running.  When the door has finished, it should return
  859.  almost instantaneously to the menu from which you started.
  860.  
  861.  [[DOS LOCAL MODE]]
  862.  You may also run WildFire in DOS LOCAL mode by changing to the WILDFIRE
  863.  directory and typing: WILDFIRE LOCAL MENUNAME, where MENUNAME of course is
  864.  the name of one of your valid menus.
  865.  
  866.  Thats WildFire!  I hope you enjoy it!!!
  867.  -----------------------------------------------------------------------------
  868.  
  869.  [[ APPENDIX A - DOOR SUPPORT FOR OTHER BBS TYPES ]]
  870.  
  871.   WildFire 1.5 automatically supports the following door types:
  872.   
  873.   The codes displayed in the editor's attribute entry window have the following
  874.   meaning.
  875.     
  876.   W = Wildcat 1.10/1.11 format. Required by most Wildcat doors available at
  877.       this writing. The file produced is CALLINFO.BBS and is placed in your
  878.       Spitfire directory.
  879.  
  880.   2 = Wildcat 1.12 format.  Required by some newer doors for Wildcat such
  881.       as Masters of the Universe. This type will become popular very
  882.       shortly. The file produced is CALLINFO.BBS and is placed in your
  883.       Spitfire directory.
  884.               
  885.   P = PCBoard 11.x thru 12.x format.  This is compatible with most known doors
  886.       that run under the PCBoard system. File produced is PCBOARD.SYS and is
  887.       placed in the Spitfire directory
  888.  
  889.   R = RBBS 15.1c+ format.  This format is compatible with version 15.1c and up
  890.       of RBBS-PC. WildFire produces a file called  DORINFO1.DEF from which the
  891.       door program will obtain it's callers information. DORINFO1.DEF is placed
  892.       in the Spitfire directory. If you are running your system on COM1, the
  893.       RBBS door will use this file directly, if your system is running COM2,
  894.       the DORINFO1.DEF MUST BE RENAMED TO DORINFO2.DEF in your DOOR_X entry
  895.       and then either file must be copied to the directory in which the
  896.       door itself will run.  Any RBBS door in a download area that you see with
  897.       a dating of 0288 or later in it's name such as CAVE0288.ARC or
  898.       KING0488.ARC can be run by WildFire.
  899.   
  900.   G = GAP format.  This format is compatible with doors written to run under
  901.       the GAP BBS system.  WildFire produces a file called DOOR.SYS and places
  902.       it in the Spitfire directory.
  903.       
  904.   Q = QBBS format.  This format is under development and should not be used at
  905.       this time although it's type code does show in the editor attribute
  906.       screen.
  907.       
  908.   In later releases of WildFire I plan to provide support for the older RBBS
  909.   doors that use the MESSAGES files to get the caller information but I still
  910.   have some research to do on the formats and different versions of RBBS.
  911.   
  912.   One other note about RBBS door support.  WildFire provides automatic LOCAL
  913.   execution for PCBoard and Wildcat doors but NOT for RBBS doors.  The format
  914.   of the local execution command is different with the RBBS doors that it
  915.   is for the other two and I haven't yet figured a way to automatically 
  916.   get them to run local.  If you want to run one of the RBBS doors in local
  917.   mode, just drop out of WildFire with the F1, DropDos key, CD over to where
  918.   the door is and just run it by typing it's name.  Local mode on these
  919.   doors does NOT require a .CFG file of any kind and does not require any
  920.   kind of local indication on the command line.
  921.   
  922.   ----------------------------------------------------------------------------
  923.  
  924.   I hope this documentation proves sufficient to get you going! But, if you
  925. have problems getting WildFire to go, give me a call on Flite-Line at
  926. 402-421-2434, 24hrs 7days at 300/1200/2400/9600 USR and I will assist you in
  927. getting it running.
  928.  
  929.   Again if you are going to continue using WildFire, please fill out the 
  930. form below and mail it to me so I can make sure you get notified of an update.
  931. Your suggestions for improvement and your bugs reports will be appreciated.
  932.  
  933. Steve Cox
  934. Flite-Line BBS
  935. 938 N. 70th, Suite 102
  936. Lincoln, Ne. 68505
  937.  
  938.  DATA 402-421-2434  300/1200/2400/9600 USR  (NODE 1)
  939.  DATA 402-421-1171  300/1200/2400           (NODE 2)
  940.  DATA 402-421-1376  300/1200/2400           (NODE 3)
  941.  
  942. ------------------------------------------------------------------------------
  943.                              LiveStuff Registration
  944.                    
  945. NAME: ________________________________     ADDRESS: __________________________
  946.  
  947. CITY: ___________________  STATE: ___   ZIP: ________  PHONE: _____________
  948.  
  949. LiveStuff system you are registering _________    SPITFIRE VERSION: _________
  950.  
  951. COMMENTS: ____________________________________________________________________
  952.           ____________________________________________________________________
  953.       ____________________________________________________________________
  954.  
  955.     Registration fees:  Single User WildFire 1.5    (registration) $30.00
  956.                         Single User LiveCat 1.5     (regsitration)  30.00
  957.                         Multi-User LiveCat  1.8/3 (3 node)          50.00
  958.             Multi-User LiveCat  1.8/4 (4+ nodes)        75.00
  959.             Upgrade from LiveMon 2.x to LiveCat         10.00
  960.             Upgrade from LiveMon 1.x to LiveCat         15.00
  961.                         LiveMon 2.3                    (New system) 15.00
  962.                         CSHELL 1.0                   (registration) 25.00
  963.                         SuperCat Single User 1.0                    50.00
  964.             SuperCat Multi-User 1-3  Nodes             100.00
  965.             SuperCat Multi-User 4-16 Nodes             125.00
  966.             
  967.             Registration fee of $_________ enclosed.
  968.  
  969. MAIL TO:            Steve Cox
  970.                     Flite-Line BBS
  971.                     938 N. 70th, Suite 102
  972.             Lincoln, Ne. 68505
  973. ______________________________________________________________________________
  974.